Администратор может читать собственные доступные файлы и делегированные CARD/BLOG/AVATAR своего салона при наличии соответствующего права. Приватные документы владельца салона не становятся доступными администратору.
Возвращает текущее состояние файла и, если файл уже доступен локально или в object storage, ссылку. Для purpose DOCUMENT и SUPPORT это ссылка на /api/file/download/{id}; endpoint скачивания проверит доступ и вернёт расшифрованный файл потоком. Для остальных purpose возвращается временная подписанная ссылка на /api/file/download/{id} независимо от текущего места хранения. Файл с purpose QR доступен по известному id без авторизации; остальные файлы сохраняют прежние ограничения доступа.
Query-параметр type выбирает, какую ссылку вернуть:
FULL— полный файлPREVIEW— preview файла, если он включён для purpose
Значения data.status:
PENDING— файл ещё обрабатывается,url = nullFAILED— обработка завершилась ошибкой,url = nullUPLOADED— файл доступен; для DOCUMENTurlведёт на защищённый endpoint скачивания, для других purpose может быть временной ссылкой
После успешного ответа upload документ уже имеет UPLOADED. Передайте его file_id в PUT /api/business-registry/registration или PUT /api/business-registry/registration/documents/reupload.
Требования:
- для purpose
QRавторизация не нужна; - для остальных файлов требуется JWT.
- https://felmee.comhttps://felmee.com/api/file/{id}
- http://localhost:8080http://localhost:8080/api/file/{id}
curl -i -X GET \
'https://felmee.com/api/file/{id}?type=FULL'Статус файла успешно получен
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "success": true, "message": "File is still processing", "codeError": null, "error_code": null, "data": { "file_id": 123, "file_name": "avatar.png", "status": "PENDING", "url": null } }